home *** CD-ROM | disk | FTP | other *** search
/ PC Media 4 / PC MEDIA CD04.iso / share / os2 / teldr000 / teldor.doc < prev    next >
Text File  |  1994-06-24  |  5KB  |  114 lines
  1. Documentation for Telnet Door version 0.00, the universal interface between an
  2. OS/2 BBS and the Internet.
  3.  
  4.   Telnet Door is a program that I initially wrote because I want to connect my
  5. BBS to the Internet via a UNIX system.  I wrote this door to enable users of
  6. my system to login to my UNIX system via OS/2s TCP/IP networking, and from
  7. access the Internet from there (once I get a connection).  I soon realised that
  8. many other sysops want to do the same thing, so I decided to release this as
  9. shareware.
  10.  
  11.    This is version 0.00 which is missing a lot of things that I would like to
  12. have included (such as much more documentation).  But I decided to get a quick
  13. release out the door and continue work based on user feedback.
  14.  
  15. +++Shareware legal statement:
  16.  
  17.    This program is not guaranteed to do anything apart from consume space on
  18. your hard drive.  If you wish to use this for more than 90 days from the date
  19. you received it you must pay me $30 Australian, for each line of your BBS that
  20. will be running this program (see below).
  21.  
  22. +++System requirements:
  23.  
  24.    This program requires at least OS/2 version 2.0 running IBM's TCP/IP
  25. networking software version 2.0 (I believe that my program is compatible with
  26. FTP software's TCP/IP for OS/2, but I haven't been able to test it).
  27. Requirements for RAM and hard drive space are so small that it won't make an
  28. impact on the typical BBS system.
  29.  
  30. +++Test system:
  31.  
  32.    This program has been extensively tested on an OS/2 system running OS/2
  33. version 2.11 with IBM's TCP/IP version 2.00 on a 486.  The target system of
  34. the TELNET was a 386 running Linux (kernel version 1.1.19 and utilities from
  35. the Slackware 1.2.0.3 distribution) and was on an ethernet segment.  Although
  36. I haven't tested them, other types of TCP/IP networks (SLIP, Token Ring, etc)
  37. should all work.  TCP/IP hides the network hardware from my application so the
  38. actual hardware being used shouldn't matter.
  39.  
  40. +++Compiler used:
  41.  
  42.    This program was compiled with IBM's Cset++ version 2.1.
  43.  
  44. +++Usage of the program:
  45.  
  46.    Here's the help screen which is displayed when you give it incorrect command
  47. line parameters:
  48.  
  49.  
  50. Can't connect.
  51. Usage: telnetdr [ OPTIONS ] hostname
  52.  
  53. hostname is in dotted decimal or *domain name* convention
  54.  
  55. Options: c=com handle        file handle for serial port if any
  56.          f=door config file  full file and path name for DORINFO1.DEF file
  57.          t=mins              time in minutes that the user may be logged in
  58.          d=filename          debugging file name
  59.          l=filename          logging file name
  60.          p=port              TCP port to login to on remote machine
  61.  
  62.   * domain names is a feature that's not yet implemented
  63. Telnet Door V0.00, copyright 1994 Russell Coker.
  64.  
  65.  
  66.    Basic usage is the same as any other Telnet program, just "teldor 193.1.1.1"
  67. or whatever the destination address is.
  68.  
  69.   For basic BBS operation it is: "teldor f=c:\path\dorinfo1.def 193.1.1.1"
  70.  
  71. The 'f' parameter specifies the fully qualified path name of the DORINFO1.DEF
  72. file which contains all necessary information on the user.  NB  The "COMx"
  73. line in the door file is taken to contain the number of the open OS/2 file
  74. handle for the serial port.  So "COM3" does not mean serial port 3 it means
  75. file handle 3 which points to a serial port.  If you don't understand this
  76. then read the documentation for Maximus or BinkleyTerm.  I don't agree with
  77. that feature being used in that way, but I know 99% of you have BBSs set up
  78. like that.  The preferred way of passing an open serial port handle is via the
  79. "C=x" command line parameter which overrides the parameter in the door file
  80. (all command line parameters take precedence over door file parameters).
  81.    This program will exit if a user tries to stay online longer than they are
  82. allowed.  It does not hang up on them, it merely tells them that their time
  83. is up and exits.  This allows the BBS software to decide exactly what to do
  84. when someone stays online too long.  The amount of time that they are allowed
  85. is taken from the command line via the "t=x" parameter, or from the door file
  86. if it's not specified on the command line (NB the doorfile is strictly
  87. optional, if you don't specify a time limit on the command line and the
  88. doorfile isn't being used then they are allowed to stay online forever).
  89.     The "p=x" command line parameter is used to specify the TCP port to login
  90. to on the remote machine.  The default is 23 (the RLOGIN port).
  91.     The parameters "d=" and "l=" are for specifying the debugging and logging
  92. file names respectively.  The logging file will store all data sent to the
  93. user on disk and may be useful to a sysop.  The debugging file will only store
  94. information on the state of my program.  The intended usage of the debugging
  95. file is for you to send it to me if you encounter a bug in my program, however
  96. if you feel curious then feel free to try and decipher it.
  97.  
  98.  
  99.    To register post a cheque for $25 Australian to:
  100.  
  101. Russell Coker,
  102. PO Box 424,
  103. Lilydale, 3140,
  104. Victoria Australia.
  105.  
  106.    To get the latest version and for technical support you can send EMAIL to
  107. the following addresses:
  108. russell.coker@p0.f363.n633.z3.fidonet.org.
  109. Russell Coker @ 3:633/363.0 @ fidonet
  110.  
  111.     Or call my BBS directly on +61-3-739-7145.
  112.  
  113.   To get the absolutely latest version FREQ "TELDOR" from 3:633/363.
  114.